home *** CD-ROM | disk | FTP | other *** search
/ PD ROM 1 / PD ROM Volume I - Macintosh Software from BMUG (1988).iso / Telecommunications / Utilities / About MacBinary... next >
Encoding:
Text File  |  1985-11-26  |  7.0 KB  |  147 lines  |  [TEXT/ttxt]
  1. MacBinary Help File (MACBIN.HLP)
  2. --------------------------------
  3.  
  4. Dennis Brothers 76703,2067
  5. 25 April 1985
  6. (6 May 1985 - minor updates)
  7.  
  8.  
  9. The following is a very brief set of notes on the use of MacBinary
  10. format on MAUG - a much more comprehensive document will be available
  11. Real Soon Now.
  12.  
  13.  
  14. 1. What is MacBinary?
  15. ---------------------
  16.  
  17. The MacBinary format is a newly-created standard format for Macintosh
  18. file transfers. It allows complete Macintosh documents (MacPaint
  19. pictures, formatted MacWrite documents, applications, desk accessories,
  20. etc.) to be transferred to or from any system that supports some
  21. form of 8-bit transparent file transfer (using protocols like Christensen
  22. [XMODEM], Kermit, CompuServe A or B, etc.). It may also be used between
  23. Macintoshes. MacBinary has several advantages over previous Macintosh
  24. file transfer schemes: it is becoming widely accepted; it permits
  25. direct transfer of any Mac document (after a download using a compatible
  26. terminal program, a finished document appears on the desktop, without
  27. the need for any conversion); and MacBinary-formatted files will generally
  28. take 25% to 50% less time to transfer. Technical details of the MacBinary
  29. format and related implementation issues may be found in the file
  30. BINARY.STD in MAUG DL8.
  31.  
  32. MacBinary is currently supported by Red Ryder Version 5 and
  33. by a free, public-domain terminal program called FreeTerm (available
  34. from MAUG). It will soon be supported by many more terminal programs,
  35. including MacTerminal. It may also be used with any terminal
  36. program that supports 8-bit transparent protocol transfers (such
  37. as MacTerminal 1.1, using XMODEM), by using BINHEX Version 5 for
  38. conversion.
  39.  
  40. MacBinary files on CompuServe have the extension .BIN (other, non-Macintosh
  41. files may also have that extension - check the file's DEScription to be
  42. sure it's for the Macintosh). Two sizes will be shown for such a file.
  43. The first (right after the date) is the size as stored on CompuServe,
  44. and is of little importance. The second, in parentheses, is the
  45. number of bytes that will be downloaded.
  46.  
  47. Note that the following sections speak only of use of XMODEM. At the
  48. present time there are no Macintosh terminal programs that support
  49. the other available protocols (CompuServe A or B). If and when such
  50. support becomes available, the procedures for using those protocols
  51. will be similar (but probably not identical) to the XMODEM procedures.
  52.  
  53.  
  54. 2. Equipping yourself to use MacBinary
  55. --------------------------------------
  56.  
  57. If you already have a terminal program that supports MacBinary (such as
  58. Red Ryder version 5), you're all set. Otherwise, you'll either have to get
  59. such a terminal program, or get BINHEX Version 5 for use with a terminal
  60. program that supports protocol transfers (like Red Ryder version 4 or
  61. MacTerminal 1.1).
  62.  
  63. In the near future, streamlined procedures for bootstrapping into MacBinary
  64. capability will be made available, but for the time being, the surest
  65. way to do it is to first get BINHEX version 4 (see BINHEX.HLP in MAUG
  66. DL0 for details on how to do that), then download either FREETM.HQX
  67. or BINHX5.HEX (the former is recommended), and convert the downloaded file
  68. to an application with BINHEX V4.
  69.  
  70. Be aware that the version of FreeTerm (0.3) currently available in MAUG
  71. DL8 is a beta-test version - use it at your own risk (though it seems
  72. pretty solid), and please report any problems with it to William Bond
  73. (74435,160) in Section 8 of the MAUG message area.
  74.  
  75.  
  76. 3. Downloading a MacBinary-format file from CompuServe
  77. ------------------------------------------------------
  78.  
  79. If you have a MacBinary-compatible terminal program, just issue the
  80. DOW command or menu choice for the file you want, and when asked,
  81. specify XMODEM protocol. After CompuServe says "Press Enter at when
  82. Transfer is Completed" (or something similar to that), tell your
  83. terminal program to start an XMODEM (MacBinary) receive (this will
  84. usually be an item under the File menu). The transfer will proceed,
  85. and your terminal program will keep you posted on progress. When the
  86. transfer is finished, press Return to tell CompuServe you're done.
  87. After exiting from your terminal program, you will find the downloaded
  88. document or application on the desktop, complete with the proper name
  89. and icon.
  90.  
  91. Note that, with a properly-written terminal program, this same procedure
  92. is used for all downloads - both text and MacBinary files. The terminal
  93. program will automatically recognize MacBinary format and do the
  94. appropriate processing.
  95.  
  96.  
  97. 4. Uploading a MacBinary-format file to CompuServe
  98. --------------------------------------------------
  99.  
  100. As might be expected, this is the opposite of downloading. In the
  101. appropriate DL section, issue the command "UPL file.BIN" (without
  102. the quotes), where "file" is a one- to six-character name (letters and
  103. digits only) that your file will have in the CompuServe DL listings
  104. (this will not affect the name it will have on disk after downloading -
  105. that will be the same as the original document). You will be prompted
  106. to choose a protocol - select XMODEM. You will then be promted to
  107. select between 7-bit (ASCII) and 8-bit (Binary) - IT IS IMPORTANT
  108. THAT YOU SELECT 8-BIT (note that this is different from the procedure
  109. used with previous Mac formats). You will then get the "Beginning XMODEM
  110. transfer...press Enter when done" (or words to that effect) message.
  111. At this point, give your terminal program the command to begin an
  112. XMODEM (MacBinary) transmission. Again, when the transfer has completed,
  113. press Return to inform CompuServe of that completion.
  114.  
  115. At this point, CompuServe will prompt you for keywords - enter a half-dozen
  116. or so meaningful keywords, separated by spaces, followed by Return. You'll
  117. then be prompted for a description (up to 500 characters in length). Try
  118. to provide as much useful detail as possible. Hit an extra Return
  119. after the last line of description, and your upload is finished.
  120.  
  121.  
  122. 5. Hints on successful XMODEM downloading
  123. -----------------------------------------
  124.  
  125.      A) Beware of peak usage times. If CompuServe is heavily loaded
  126.         (as it tends to be during evening hours), transmission delays may
  127.         cause your terminal program to time out.
  128.  
  129.      B) If at all possible, dial directly into a CIS node. People have
  130.         reported having trouble with XMODEM downloads through Tymnet
  131.         and Telenet nodes.
  132.  
  133.      C) If you have a failure during an XMODEM download, exit from DL
  134.         and re-enter before trying again - there seems to be a bug in
  135.         the SIG software that "poisons" subsequent download attempts
  136.     after a failure.
  137.  
  138.  
  139. 6. If it is completely impossible to use XMODEM to download...
  140. --------------------------------------------------------------
  141.  
  142. It is possible to do a straight text download of a .BIN file, using the
  143. R(ead) command. The resulting file is in CompuServe's internal HEX
  144. format, and is more than twice as long as an XMODEM download would have
  145. been. It may be converted to a form compatible with BINHEX V5 through
  146. use of the FIXHEX.BAS program available in MAUG's DL8 database.